home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / emulation / shapeshifter / extras / macjoy_1.1 / macjoypad.doc < prev    next >
Encoding:
Text File  |  1995-09-28  |  3.6 KB  |  68 lines
  1.  
  2.         MacJoypad V1.0 - 1995 by Francesco Doro (fdoro@gpnet.it)
  3.  
  4.   MacJoypad is similar to MacJoy (see MacJoy.doc) but it gives support to
  5. the CD32 joypad and all his buttons.  It could be used also with joystick
  6. but in this case you MUST set a tooltype 'JOYSTICK' or you will get
  7. garbage; this tooltype is already in the icon, remove brackets to make it
  8. effective.  When using joystick RED is the first fire button and BLUE the
  9. second (if present).  If the JOYSTICK option is active but you use joypad
  10. it works well but it will not handle all buttons of the joypad, only the
  11. RED, BLUE and directions.  Anyway if you use joystick I RECOMMEND using
  12. MacJoy instead of MacJoypad since MacJoy is more reliable and OS friendly
  13. and takes less CPU time than MacJoypad (it also takes less CPU time than
  14. using keyboard...).  You could use MacJoy also for joypad; in this case
  15. FIRE1 is the red button, FIRE2 is the BLUE botton.  Use MacJoypad only if
  16. you really need all those buttons.
  17.  
  18.   MacJoypad needs lowlevel.library (not included).  This library is part of
  19. WorkBench 3.1.
  20.  
  21.   You can configure MacJoypad like MacJoy, using the tooltypes stored in
  22. his icon.  Joypad's buttons have different colors and shapes; some have
  23. special names:  FORWARD is that with the '>>', REVERSE is '<<' and PLAY is
  24. '||>'.  The default configuration is:  directions to cursor keys, RED to
  25. space, BLUE to right alt, GREEN to return, YELLOW to tab, FORWARD to
  26. control, REVERSE to left shift, PLAY to m (like map...).  MacJoypad will
  27. use this config if launched from shell or if it doesnt find tooltypes.  If
  28. launched from shell it's better using 'run >nil:  ...'; if enough people
  29. will ask for a shell interface I'll add it in a next release (only for
  30. MacJoypad).
  31.  
  32.   MacJoypad is NOT a commodity, it will open a small window on workbench
  33. screen; to remove it you have to close that window.  You can launch and
  34. quit it at any time even during mac emulation.
  35.  
  36. IMPORTANT:
  37.   MacJoypad is specific for the CD32 joypad, I think it can't work with
  38. other joypads; please don't ask support for other joypads since I own only
  39. the CD32's one.  In general joypads are not as simple to handle like
  40. joysticks, you require docs and a joypad to experiment.
  41.   I've heard rumours that some A1200 have a hardware problem with the CD32
  42. joypad; in my tests I have not found any problem with 500, 1200 and 4000
  43. but usually I'm very lucky with computers (much more than with girls :-).
  44.  
  45. Known bugs and problems:
  46.   MacJoypad uses some features of lowlevel.library that cannot be shared
  47. between applications, so if another program tries to use them when
  48. MacJoypad is active it will probably fail.
  49.   Lowlevel.library actually is far from perfection; according to autodocs
  50. it should be able to detect what type of device is connected to the
  51. gameport but in my tests this is not reliable:  it recognizes only mouse,
  52. if it find a joystick or a joypad it returns unknown device.  For this
  53. reason you have to tell MacJoypad if there is a joystick instead of joypad.
  54.   MacJoypad requires kickstart 2.0 or better, otherwise it wont do nothing,
  55. not even an error message (but it wont crash).
  56.  
  57. Copyright:
  58.   MacJoypad is entirely work of mine so I can say it is 100% free and
  59. Public Domain; do with it what you want but don't expect any guarantee from
  60. me about his reliability or eventual damages it could produce.
  61.   Anyway please report any problems or bugs you find and probably I will
  62. fix them; include infos about your system and version of lowlevel.library;
  63. my e-mail address is:  fdoro@gpnet.it.
  64.  
  65. Credits:
  66.   Thanks to Michel Labbé for hint about lowlevel.library, for beta testing
  67. and for having convinced me to do this small utility.
  68.